Skip to content

Add LLM-consumer awareness to skill review criteria#149

Merged
shinpr merged 1 commit intomainfrom
feature/optimize-skill-creation
Mar 30, 2026
Merged

Add LLM-consumer awareness to skill review criteria#149
shinpr merged 1 commit intomainfrom
feature/optimize-skill-creation

Conversation

@shinpr
Copy link
Copy Markdown
Owner

@shinpr shinpr commented Mar 30, 2026

Summary

  • skill-reviewer was applying BP patterns as if skills were human-facing documents, causing false positives that blocked valid skill content
  • Added skill exceptions to BP-002 (context-resolvable expressions are not vague), BP-005 (LLM baseline knowledge terms need no definition), and refined Principle 2 (re-mentions at different structural roles are not duplicates if they add new constraints)
  • Applied to both en and ja skill variants

Test plan

  • Run skill-reviewer on a skill containing standard technical terms without definitions — confirm no BP-005 false positive
  • Run skill-reviewer on a skill with context-dependent expressions — confirm no BP-002 false positive
  • Run skill-reviewer on a skill with genuine vagueness or missing definitions — confirm issues are still detected
  • Verify Principle 2 allows structural-role re-mentions only when new constraints are added

🤖 Generated with Claude Code

skill-reviewer was flagging valid skill content as issues because BP
patterns were applied without considering that skills are consumed by
LLMs, not humans. Added skill exceptions to BP-002, BP-005, and
refined Principle 2 deduplication criteria.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@shinpr shinpr self-assigned this Mar 30, 2026
@shinpr shinpr merged commit b2d089a into main Mar 30, 2026
1 check passed
@shinpr shinpr deleted the feature/optimize-skill-creation branch March 30, 2026 04:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant